Original Standard File Reply Record

When you use one of the original Standard File Package procedures SFPutFile , SFGetFile , SFPPutFile , or SFPGetFile , you pass a reply record of type SFReply .



 
SFReply =

RECORD

    good:           Boolean;        {TRUE if user did not cancel}

    copy:           Boolean;        {reserved}

    fType:          OSType;         {file type}

    vRefNum:        Integer;        {working directory reference number}

    version:        Integer;        {reserved}

    fName:          Str63;          {filename}

END;

good: Reports whether the reply record is valid. The value is TRUE after the user clicks Save or Open; FALSE after the user clicks Cancel. When the user has completed the dialog box, the other fields in the reply record are valid only if the value of good is TRUE .
copy: Reserved.
fType: Contains the file type of the selected file. (File types are described in the chapter "Finder Interface" of Inside Macintosh: Macintosh Toolbox Essentials .) Only SFGetFile and SFPGetFile return a file type in this field.
vRefNum: Contains the working directory reference number of the selected file.
version: Reserved.
fName: Contains the name of the selected file.

In spite of its name, the vRefNum field does not contain a volume reference number. Instead, it contains a working directory reference number, which encodes both the volume reference number and the parent directory ID of the selected file. You can obtain the volume reference number and directory ID of the file by calling GetWDInfo or PBGetWDInfo . See the chapter "File Manager" in this book for details about working directory reference numbers.

Previous | Chapter Top | Chapter Contents | Next